﻿<!DOCTYPE HTML>
<html lang="zh">
<head>
<title>ToolTip - 语法 &amp; 使用 | AutoHotkey v2</title>
<meta name="description" content="The ToolTip function creates an always-on-top window anywhere on the screen." />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
</head>
<body>

<h1>ToolTip</h1>

<p>在屏幕的任意位置创建置顶的窗口.</p>

<pre class="Syntax"><span class="func">ToolTip</span> <span class="optional">Text, X, Y, WhichToolTip</span></pre>
<h2 id="Parameters">参数</h2>
<dl>

  <dt>Text</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
    <p>如果为空或省略, 则隐藏现有的工具提示(如果有). 否则, 此参数为要在工具提示中显示的文本. 要创建多行的工具提示, 请在每行之间使用换行符(`n), 例如 Line1`nLine2.</p>
    <p>如果 <em>Text</em> 较长, 可以通过<a href="../Scripts.htm#continuation">延续片段</a>的方法将其分解成较短的几行, 这样可以增加可读性和可维护性.</p>
  </dd>

  <dt>X, Y</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#numbers">整数</a></p>
    <p>相对于活动窗口的 X 和 Y 坐标(请使用 <code><a href="CoordMode.htm">CoordMode</a> "ToolTip"</code> 来让坐标相对于屏幕). 如果省略坐标, 则工具提示显示在鼠标光标附近.</p>
  </dd>

  <dt>WhichToolTip</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#numbers">整数</a></p>
    <p>如果您不需要同时显示多个工具提示, 请省略此参数. 否则, 请指定一个介于 1 和 20 之间的数字来表示要操作的工具提示窗口. 如果未指定, 则此数字为 1(首个).</p>
  </dd>

</dl>

<h2 id="Return_Value">返回值</h2>
<p>类型: <a href="../Concepts.htm#numbers">整数</a>或<a href="../Concepts.htm#nothing">空字符串</a></p>
<p>如果一个工具提示正在显示或更新, 这个函数返回工具提示窗口的<a href="../misc/WinTitle.htm#ahk_id">唯一 ID(HWND)</a>, 它可以用来移动工具提示或发送<a href="https://docs.microsoft.com/en-us/windows/win32/controls/bumper-tooltip-control-reference-messages">工具提示控制消息</a>.</p>
<p>如果省略 <em>Text</em> 或为空, 返回值为空字符串.</p>

<h2 id="Remarks">备注</h2>
<p>工具提示通常看起来像这样: <img src="../static/dlg_tooltip.png" alt="ToolTip" style="vertical-align: middle" /></p>
<p>如果 X &amp; Y 坐标让工具提示离开屏幕, or outside the <a href="MonitorGetWorkArea.htm">monitor's working area</a> on Windows 8 or later, 则会对其进行重新定位以使其完全可见.</p>
<p>工具提示会一直显示, 直到出现以下情况之一:</p>
<ul>
  <li>脚本终止.</li>
  <li>再次执行 ToolTip 函数, 并且 <em>Text</em> 参数为空.</li>
  <li>用户点击了工具提示(此行为可能因操作系统版本而有所不同).</li>
</ul>
<p>GUI 窗口可以通过 <a href="Gui.htm#OwnDialogs">OwnDialogs 选项</a>成为工具提示的所有者. 这样的工具提示在其拥有者被销毁时也会自动被销毁.</p>
<h2 id="Related">相关</h2>
<p><a href="CoordMode.htm">CoordMode</a>, <a href="TrayTip.htm">TrayTip</a>, <a href="Gui.htm">GUI</a>, <a href="MsgBox.htm">MsgBox</a>, <a href="InputBox.htm">InputBox</a>, <a href="FileSelect.htm">FileSelect</a>, <a href="DirSelect.htm">DirSelect</a></p>
<h2 id="Examples">示例</h2>
<div class="ex" id="ExBasic">
<p><a class="ex_number" href="#ExBasic"></a> 在活动窗口的特定位置显示一个多行工具提示.</p>
<pre>ToolTip "Multiline`nTooltip", 100, 150</pre>
</div>

<div class="ex" id="ExAutoHide">
<p><a class="ex_number" href="#ExAutoHide"></a> 在一段时间后隐藏工具提示, 而不使用 Sleep(它会停止当前线程).</p>
<pre>ToolTip "Timed ToolTip`nThis will be displayed for 5 seconds."
SetTimer () =&gt; ToolTip(), -5000</pre>
</div>

</body>
</html>